spotter (متوقف)

الإضافة مفتوحة المصدر spotter أداة لبرنامج QGIS تبسّط سير العمل في استيراد البيانات الجغرافية وتصديرها، وتركّز خصوصًا على ملفات CSV وDXF.

الوظائف الرئيسية

1. استيراد CSV: يتيح استيراد البيانات من ملفات CSV وضبط الحقول المستعملة وإنشاء طبقة مسنَدة جغرافيًا

   • اختيار الملف: يمكن للمستخدم اختيار ملف CSV للاستيراد عبر نافذة حوار
   • ضبط الحقول: تقرأ الإضافة ترويسة ملف CSV (إن وُجدت) وتتيح اختيار الحقول المراد تضمينها
   • تحديد الحقول الأساسية: يمكن تحديد الأعمدة التي تمثّل الاسم وخط العرض وخط الطول. وهذه الحقول إلزامية للإسناد الجغرافي الصحيح للبيانات
   • إنشاء طبقة مؤقتة: بعد استيراد البيانات تنشئ الإضافة طبقة في الذاكرة يتحوّل فيها كل سجل إلى عنصر نقطي (Point)
   • التسمية التلقائية: إن وُجد حقل الاسم تضبط الإضافة تسمية الطبقة تلقائيًا، فيسهل تمييز العناصر على الخريطة

الشكل 1 وظائف استيراد ملفات .csv

2. تصدير CSV: يتيح اختيار طبقة موجودة في المشروع واختيار الحقول المراد تصديرها وضبط نظام الإحداثيات وحفظ البيانات في ملف CSV جديد

   • اختيار الطبقة المراد تصديرها: تسرد الإضافة الطبقات الموجودة حاليًا في مشروع QGIS ليختار المستخدم منها
   • ضبط التصدير: يمكن للمستخدم تحديد ما إذا كان سيُدرج الترويسة واختيار الحقول المراد تصديرها
   • اختيار نظام الإحداثيات للخرج: يمكن اختيار نظام الإسناد (Coordinate Reference System) للتصدير، بما يضمن توافق البيانات
   • حفظ الملف: تصدّر الإضافة البيانات بصيغة CSV مطبِّقةً تحويلات الإحداثيات وتنسيق الأرقام عند اللزوم، وتعرض شريط تقدّم أثناء العملية

الشكل 2 وظائف تصدير ملفات .csv

3. استيراد DXF: يوفّر أدوات لتحميل ملفات DXF والتحقق من صحة الهندسة ووضع المحتوى على الخريطة بأداة تفاعلية (بالنقر على الخريطة)

   • اختيار ملف DXF: يتيح اختيار ملف DXF يتضمن هندسة (خطوطًا أو مضلّعات)
   • التحقق من الهندسة: تتحقق الإضافة من أن جميع الأشكال الهندسية في ملف DXF صحيحة ومدعومة (الخطوط والمضلّعات فقط)
   • الوضع على الخريطة: بعد التحقق من الملف ينقر المستخدم على الخريطة لتحديد أصل الإزاحة، فيوضع ملف DXF على النحو الصحيح في نظام إحداثيات المشروع
   • إنشاء طبقة في الذاكرة: بعد الوضع تُنشأ طبقة مؤقتة تعرض محتوى ملف DXF بنمط أساسي (رمز أحمر مثلًا) لتسهيل تمييزه

الشكل 3 وظائف استيراد ملفات .dxf

4. Info: تعرض معلومات عن الإضافة، منها الإصدار والمؤلف والوصف والترخيص وروابط مفيدة. ويمكن هنا أيضًا إدراج وسائل التبرع وموارد الدعم الأخرى

   • الوصف والبيانات الوصفية: في علامة التبويب «Info» تقدّم الإضافة نظرة عامة تتضمن الإصدار والمؤلف ووصفًا موجزًا وروابط الترخيص ومستودع GitHub وموارد أخرى
   • روابط الدعم: يمكن ضبط روابط للتواصل مع المؤلف (بالبريد الإلكتروني مثلًا) أو للتبرع عبر قنوات مختلفة (PayPal وPatreon وKo-fi وغيرها)، مما يتيح للمستخدمين طرقًا متعددة لدعم المشروع

الشكل 4 معلومات عن البرنامج

كيف أنزّلها؟

• التثبيت:

  • تُوزَّع الإضافة شيفرةً مصدرية يمكن تنزيلها من GitHub مضغوطة من هنا
  • وبعد تثبيتها عبر مدير الإضافات في QGIS تظهر أيقونة و/أو بند قائمة باسم «spotter»

كيف تُستعمل؟

• تشغيل الإضافة:

  • بالنقر على الأيقونة أو باختيار الإضافة من القائمة تُفتح نافذة الحوار بعلامات التبويب المختلفة

• سير العمل:

  • لاستيراد بيانات CSV: اختر الملف واضبط الحقول ثم استورد. وستُضاف الطبقة إلى المشروع ويمكنك تعديلها مباشرةً
  • لتصدير البيانات: اختر الطبقة المراد تصديرها واضبط المعاملات واحفظ ملف CSV بالإحداثيات المحوَّلة عند اللزوم
  • لاستيراد DXF: اختر ملف DXF وتحقّق من الهندسة وضع المحتوى على الخريطة بالنقر في الموضع المطلوب

فيديو

• تنزيل إضافة spotter وتثبيتها في QGIS من هنا
• تقديم موجز للإضافة واستعمالها مع csv2dat عبر هذا الرابط

البنية

جُرّبت الإضافة مع أحدث إصدارات QGIS ابتداءً من 3.34، وهي مقسَّمة إلى عدة ملفات لفصل المكوّنات:

main.py: يتضمن تعريف الصنف CombinedCsvDialog الذي يدير واجهة المستخدم وجميع الوظائف. وفيه تُعرَّف طرائق كل علامة تبويب (استيراد CSV، تصدير CSV، استيراد DXF، علامة التبويب Info) ومنطق عملها.

spotter_plugin.py: يعرّف الصنف الرئيسي SpotterPlugin الذي يدمج نافذة الحوار في دورة حياة إضافات QGIS. وفيه تُدار التهيئة وإضافة الإجراء إلى الواجهة وبدء الإضافة وإغلاقها.

__init__.py: يتضمن الدالة classFactory(iface) التي تعرّف QGIS بالإضافة. وهي تستورد الصنف SpotterPlugin وتعيده، فيتمكن QGIS من تهيئة الإضافة على النحو الصحيح.

ملفات أخرى (اختيارية): ملفات موارد (مثل icon.png للأيقونة) وملفات ترخيص (مثل LICENSE) لتوثيق ترخيص الإضافة.

ملاحظة

• spotter مشروع مفتوح المصدر بترخيص GPL-3.0 license
• يمكنكم دعم المشروع من هنا
• ويمكنكم طلب تعديلات أو إضافات مخصصة بمراسلتنا على solutop@gmail.com
• ويمكنكم تعديل الشيفرة المصدرية شريطة الإبقاء على الترخيص المذكور أعلاه